<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<title>GtkAction: GTK+ 3 Reference Manual</title>
<meta name="generator" content="DocBook XSL Stylesheets Vsnapshot">
<link rel="home" href="index.html" title="GTK+ 3 Reference Manual">
<link rel="up" href="DeprecatedObjects.html" title="Deprecated">
<link rel="prev" href="GtkActionGroup.html" title="GtkActionGroup">
<link rel="next" href="GtkToggleAction.html" title="GtkToggleAction">
<meta name="generator" content="GTK-Doc V1.33.1 (XML mode)">
<link rel="stylesheet" href="style.css" type="text/css">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table class="navigation" id="top" width="100%" summary="Navigation header" cellpadding="2" cellspacing="5"><tr valign="middle">
<td width="100%" align="left" class="shortcuts">
<a href="#" class="shortcut">Top</a><span id="nav_description">  <span class="dim">|</span> 
                  <a href="#GtkAction.description" class="shortcut">Description</a></span><span id="nav_hierarchy">  <span class="dim">|</span> 
                  <a href="#GtkAction.object-hierarchy" class="shortcut">Object Hierarchy</a></span><span id="nav_interfaces">  <span class="dim">|</span> 
                  <a href="#GtkAction.implemented-interfaces" class="shortcut">Implemented Interfaces</a></span><span id="nav_properties">  <span class="dim">|</span> 
                  <a href="#GtkAction.properties" class="shortcut">Properties</a></span><span id="nav_signals">  <span class="dim">|</span> 
                  <a href="#GtkAction.signals" class="shortcut">Signals</a></span>
</td>
<td><a accesskey="h" href="index.html"><img src="home.png" width="16" height="16" border="0" alt="Home"></a></td>
<td><a accesskey="u" href="DeprecatedObjects.html"><img src="up.png" width="16" height="16" border="0" alt="Up"></a></td>
<td><a accesskey="p" href="GtkActionGroup.html"><img src="left.png" width="16" height="16" border="0" alt="Prev"></a></td>
<td><a accesskey="n" href="GtkToggleAction.html"><img src="right.png" width="16" height="16" border="0" alt="Next"></a></td>
</tr></table>
<div class="refentry">
<a name="GtkAction"></a><div class="titlepage"></div>
<div class="refnamediv"><table width="100%"><tr>
<td valign="top">
<h2><span class="refentrytitle"><a name="GtkAction.top_of_page"></a>GtkAction</span></h2>
<p>GtkAction — A deprecated action which can be triggered by a menu or toolbar item</p>
</td>
<td class="gallery_image" valign="top" align="right"></td>
</tr></table></div>
<div class="refsect1">
<a name="GtkAction.functions"></a><h2>Functions</h2>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="functions_proto_type">
<col class="functions_proto_name">
</colgroup>
<tbody>
<tr>
<td class="function_type">
<a class="link" href="GtkAction.html" title="GtkAction"><span class="returnvalue">GtkAction</span></a> *
</td>
<td class="function_name">
<a class="link" href="GtkAction.html#gtk-action-new" title="gtk_action_new ()">gtk_action_new</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">const <span class="returnvalue">gchar</span> *
</td>
<td class="function_name">
<a class="link" href="GtkAction.html#gtk-action-get-name" title="gtk_action_get_name ()">gtk_action_get_name</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="GtkAction.html#gtk-action-is-sensitive" title="gtk_action_is_sensitive ()">gtk_action_is_sensitive</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="GtkAction.html#gtk-action-get-sensitive" title="gtk_action_get_sensitive ()">gtk_action_get_sensitive</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkAction.html#gtk-action-set-sensitive" title="gtk_action_set_sensitive ()">gtk_action_set_sensitive</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="GtkAction.html#gtk-action-is-visible" title="gtk_action_is_visible ()">gtk_action_is_visible</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="GtkAction.html#gtk-action-get-visible" title="gtk_action_get_visible ()">gtk_action_get_visible</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkAction.html#gtk-action-set-visible" title="gtk_action_set_visible ()">gtk_action_set_visible</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkAction.html#gtk-action-activate" title="gtk_action_activate ()">gtk_action_activate</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *
</td>
<td class="function_name">
<a class="link" href="GtkAction.html#gtk-action-create-icon" title="gtk_action_create_icon ()">gtk_action_create_icon</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *
</td>
<td class="function_name">
<a class="link" href="GtkAction.html#gtk-action-create-menu-item" title="gtk_action_create_menu_item ()">gtk_action_create_menu_item</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *
</td>
<td class="function_name">
<a class="link" href="GtkAction.html#gtk-action-create-tool-item" title="gtk_action_create_tool_item ()">gtk_action_create_tool_item</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *
</td>
<td class="function_name">
<a class="link" href="GtkAction.html#gtk-action-create-menu" title="gtk_action_create_menu ()">gtk_action_create_menu</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">GSList</span> *
</td>
<td class="function_name">
<a class="link" href="GtkAction.html#gtk-action-get-proxies" title="gtk_action_get_proxies ()">gtk_action_get_proxies</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkAction.html#gtk-action-connect-accelerator" title="gtk_action_connect_accelerator ()">gtk_action_connect_accelerator</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkAction.html#gtk-action-disconnect-accelerator" title="gtk_action_disconnect_accelerator ()">gtk_action_disconnect_accelerator</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkAction.html#gtk-action-block-activate" title="gtk_action_block_activate ()">gtk_action_block_activate</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkAction.html#gtk-action-unblock-activate" title="gtk_action_unblock_activate ()">gtk_action_unblock_activate</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="GtkAction.html#gtk-action-get-always-show-image" title="gtk_action_get_always_show_image ()">gtk_action_get_always_show_image</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkAction.html#gtk-action-set-always-show-image" title="gtk_action_set_always_show_image ()">gtk_action_set_always_show_image</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">const <span class="returnvalue">gchar</span> *
</td>
<td class="function_name">
<a class="link" href="GtkAction.html#gtk-action-get-accel-path" title="gtk_action_get_accel_path ()">gtk_action_get_accel_path</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkAction.html#gtk-action-set-accel-path" title="gtk_action_set_accel_path ()">gtk_action_set_accel_path</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">GClosure</span> *
</td>
<td class="function_name">
<a class="link" href="GtkAction.html#gtk-action-get-accel-closure" title="gtk_action_get_accel_closure ()">gtk_action_get_accel_closure</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkAction.html#gtk-action-set-accel-group" title="gtk_action_set_accel_group ()">gtk_action_set_accel_group</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkAction.html#gtk-action-set-label" title="gtk_action_set_label ()">gtk_action_set_label</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">const <span class="returnvalue">gchar</span> *
</td>
<td class="function_name">
<a class="link" href="GtkAction.html#gtk-action-get-label" title="gtk_action_get_label ()">gtk_action_get_label</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkAction.html#gtk-action-set-short-label" title="gtk_action_set_short_label ()">gtk_action_set_short_label</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">const <span class="returnvalue">gchar</span> *
</td>
<td class="function_name">
<a class="link" href="GtkAction.html#gtk-action-get-short-label" title="gtk_action_get_short_label ()">gtk_action_get_short_label</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkAction.html#gtk-action-set-tooltip" title="gtk_action_set_tooltip ()">gtk_action_set_tooltip</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">const <span class="returnvalue">gchar</span> *
</td>
<td class="function_name">
<a class="link" href="GtkAction.html#gtk-action-get-tooltip" title="gtk_action_get_tooltip ()">gtk_action_get_tooltip</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkAction.html#gtk-action-set-stock-id" title="gtk_action_set_stock_id ()">gtk_action_set_stock_id</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">const <span class="returnvalue">gchar</span> *
</td>
<td class="function_name">
<a class="link" href="GtkAction.html#gtk-action-get-stock-id" title="gtk_action_get_stock_id ()">gtk_action_get_stock_id</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkAction.html#gtk-action-set-gicon" title="gtk_action_set_gicon ()">gtk_action_set_gicon</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">GIcon</span> *
</td>
<td class="function_name">
<a class="link" href="GtkAction.html#gtk-action-get-gicon" title="gtk_action_get_gicon ()">gtk_action_get_gicon</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkAction.html#gtk-action-set-icon-name" title="gtk_action_set_icon_name ()">gtk_action_set_icon_name</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">const <span class="returnvalue">gchar</span> *
</td>
<td class="function_name">
<a class="link" href="GtkAction.html#gtk-action-get-icon-name" title="gtk_action_get_icon_name ()">gtk_action_get_icon_name</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkAction.html#gtk-action-set-visible-horizontal" title="gtk_action_set_visible_horizontal ()">gtk_action_set_visible_horizontal</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="GtkAction.html#gtk-action-get-visible-horizontal" title="gtk_action_get_visible_horizontal ()">gtk_action_get_visible_horizontal</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkAction.html#gtk-action-set-visible-vertical" title="gtk_action_set_visible_vertical ()">gtk_action_set_visible_vertical</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="GtkAction.html#gtk-action-get-visible-vertical" title="gtk_action_get_visible_vertical ()">gtk_action_get_visible_vertical</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">void</span>
</td>
<td class="function_name">
<a class="link" href="GtkAction.html#gtk-action-set-is-important" title="gtk_action_set_is_important ()">gtk_action_set_is_important</a> <span class="c_punctuation">()</span>
</td>
</tr>
<tr>
<td class="function_type">
<span class="returnvalue">gboolean</span>
</td>
<td class="function_name">
<a class="link" href="GtkAction.html#gtk-action-get-is-important" title="gtk_action_get_is_important ()">gtk_action_get_is_important</a> <span class="c_punctuation">()</span>
</td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect1">
<a name="GtkAction.properties"></a><h2>Properties</h2>
<div class="informaltable"><table class="informaltable" border="0">
<colgroup>
<col width="150px" class="properties_type">
<col width="300px" class="properties_name">
<col width="200px" class="properties_flags">
</colgroup>
<tbody>
<tr>
<td class="property_type">
<a class="link" href="GtkActionGroup.html" title="GtkActionGroup"><span class="type">GtkActionGroup</span></a> *</td>
<td class="property_name"><a class="link" href="GtkAction.html#GtkAction--action-group" title="The “action-group” property">action-group</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type"><span class="type">gboolean</span></td>
<td class="property_name"><a class="link" href="GtkAction.html#GtkAction--always-show-image" title="The “always-show-image” property">always-show-image</a></td>
<td class="property_flags">Read / Write / Construct</td>
</tr>
<tr>
<td class="property_type">
<span class="type">GIcon</span> *</td>
<td class="property_name"><a class="link" href="GtkAction.html#GtkAction--gicon" title="The “gicon” property">gicon</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type"><span class="type">gboolean</span></td>
<td class="property_name"><a class="link" href="GtkAction.html#GtkAction--hide-if-empty" title="The “hide-if-empty” property">hide-if-empty</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type">
<span class="type">char</span> *</td>
<td class="property_name"><a class="link" href="GtkAction.html#GtkAction--icon-name" title="The “icon-name” property">icon-name</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type"><span class="type">gboolean</span></td>
<td class="property_name"><a class="link" href="GtkAction.html#GtkAction--is-important" title="The “is-important” property">is-important</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type">
<span class="type">char</span> *</td>
<td class="property_name"><a class="link" href="GtkAction.html#GtkAction--label" title="The “label” property">label</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type">
<span class="type">char</span> *</td>
<td class="property_name"><a class="link" href="GtkAction.html#GtkAction--name" title="The “name” property">name</a></td>
<td class="property_flags">Read / Write / Construct Only</td>
</tr>
<tr>
<td class="property_type"><span class="type">gboolean</span></td>
<td class="property_name"><a class="link" href="GtkAction.html#GtkAction--sensitive" title="The “sensitive” property">sensitive</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type">
<span class="type">char</span> *</td>
<td class="property_name"><a class="link" href="GtkAction.html#GtkAction--short-label" title="The “short-label” property">short-label</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type">
<span class="type">char</span> *</td>
<td class="property_name"><a class="link" href="GtkAction.html#GtkAction--stock-id" title="The “stock-id” property">stock-id</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type">
<span class="type">char</span> *</td>
<td class="property_name"><a class="link" href="GtkAction.html#GtkAction--tooltip" title="The “tooltip” property">tooltip</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type"><span class="type">gboolean</span></td>
<td class="property_name"><a class="link" href="GtkAction.html#GtkAction--visible" title="The “visible” property">visible</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type"><span class="type">gboolean</span></td>
<td class="property_name"><a class="link" href="GtkAction.html#GtkAction--visible-horizontal" title="The “visible-horizontal” property">visible-horizontal</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type"><span class="type">gboolean</span></td>
<td class="property_name"><a class="link" href="GtkAction.html#GtkAction--visible-overflown" title="The “visible-overflown” property">visible-overflown</a></td>
<td class="property_flags">Read / Write</td>
</tr>
<tr>
<td class="property_type"><span class="type">gboolean</span></td>
<td class="property_name"><a class="link" href="GtkAction.html#GtkAction--visible-vertical" title="The “visible-vertical” property">visible-vertical</a></td>
<td class="property_flags">Read / Write</td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect1">
<a name="GtkAction.signals"></a><h2>Signals</h2>
<div class="informaltable"><table class="informaltable" border="0">
<colgroup>
<col width="150px" class="signal_proto_type">
<col width="300px" class="signal_proto_name">
<col width="200px" class="signal_proto_flags">
</colgroup>
<tbody><tr>
<td class="signal_type"><span class="returnvalue">void</span></td>
<td class="signal_name"><a class="link" href="GtkAction.html#GtkAction-activate" title="The “activate” signal">activate</a></td>
<td class="signal_flags">No Recursion</td>
</tr></tbody>
</table></div>
</div>
<div class="refsect1">
<a name="GtkAction.other"></a><h2>Types and Values</h2>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="other_proto_type">
<col class="other_proto_name">
</colgroup>
<tbody>
<tr>
<td class="datatype_keyword">struct</td>
<td class="function_name"><a class="link" href="GtkAction.html#GtkAction-struct" title="struct GtkAction">GtkAction</a></td>
</tr>
<tr>
<td class="datatype_keyword">struct</td>
<td class="function_name"><a class="link" href="GtkAction.html#GtkActionClass" title="struct GtkActionClass">GtkActionClass</a></td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect1">
<a name="GtkAction.object-hierarchy"></a><h2>Object Hierarchy</h2>
<pre class="screen">    GObject
    <span class="lineart">╰──</span> GtkAction
        <span class="lineart">├──</span> <a class="link" href="GtkToggleAction.html" title="GtkToggleAction">GtkToggleAction</a>
        <span class="lineart">╰──</span> <a class="link" href="GtkRecentAction.html" title="GtkRecentAction">GtkRecentAction</a>
</pre>
</div>
<div class="refsect1">
<a name="GtkAction.implemented-interfaces"></a><h2>Implemented Interfaces</h2>
<p>
GtkAction implements
 <a class="link" href="GtkBuildable.html" title="GtkBuildable">GtkBuildable</a>.</p>
</div>
<div class="refsect1">
<a name="GtkAction.includes"></a><h2>Includes</h2>
<pre class="synopsis">#include &lt;gtk/gtk.h&gt;
</pre>
</div>
<div class="refsect1">
<a name="GtkAction.description"></a><h2>Description</h2>
<div class="blockquote"><blockquote class="blockquote"><p>In GTK+ 3.10, GtkAction has been deprecated. Use <span class="type">GAction</span>
instead, and associate actions with <a class="link" href="GtkActionable.html" title="GtkActionable"><span class="type">GtkActionable</span></a> widgets. Use
<span class="type">GMenuModel</span> for creating menus with <a class="link" href="GtkMenu.html#gtk-menu-new-from-model" title="gtk_menu_new_from_model ()"><code class="function">gtk_menu_new_from_model()</code></a>.</p></blockquote></div>
<p>Actions represent operations that the user can be perform, along with
some information how it should be presented in the interface. Each action
provides methods to create icons, menu items and toolbar items
representing itself.</p>
<p>As well as the callback that is called when the action gets activated,
the following also gets associated with the action:</p>
<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; ">
<li class="listitem"><p>a name (not translated, for path lookup)</p></li>
<li class="listitem"><p>a label (translated, for display)</p></li>
<li class="listitem"><p>an accelerator</p></li>
<li class="listitem"><p>whether label indicates a stock id</p></li>
<li class="listitem"><p>a tooltip (optional, translated)</p></li>
<li class="listitem"><p>a toolbar label (optional, shorter than label)</p></li>
</ul></div>
<p>The action will also have some state information:</p>
<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; ">
<li class="listitem"><p>visible (shown/hidden)</p></li>
<li class="listitem"><p>sensitive (enabled/disabled)</p></li>
</ul></div>
<p>Apart from regular actions, there are <a class="link" href="GtkToggleAction.html" title="GtkToggleAction">toggle actions</a>,
which can be toggled between two states and
<a class="link" href="GtkRadioAction.html" title="GtkRadioAction">radio actions</a>, of which only one in a group
can be in the “active” state. Other actions can be implemented as <a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a>
subclasses.</p>
<p>Each action can have one or more proxy widgets. To act as an action proxy,
widget needs to implement <a class="link" href="GtkActivatable.html" title="GtkActivatable"><span class="type">GtkActivatable</span></a> interface. Proxies mirror the state
of the action and should change when the action’s state changes. Properties
that are always mirrored by proxies are <a class="link" href="GtkAction.html#GtkAction--sensitive" title="The “sensitive” property"><span class="type">“sensitive”</span></a> and
<a class="link" href="GtkAction.html#GtkAction--visible" title="The “visible” property"><span class="type">“visible”</span></a>. <a class="link" href="GtkAction.html#GtkAction--gicon" title="The “gicon” property"><span class="type">“gicon”</span></a>, <a class="link" href="GtkAction.html#GtkAction--icon-name" title="The “icon-name” property"><span class="type">“icon-name”</span></a>, <a class="link" href="GtkAction.html#GtkAction--label" title="The “label” property"><span class="type">“label”</span></a>,
<a class="link" href="GtkAction.html#GtkAction--short-label" title="The “short-label” property"><span class="type">“short-label”</span></a> and <a class="link" href="GtkAction.html#GtkAction--stock-id" title="The “stock-id” property"><span class="type">“stock-id”</span></a> properties are only mirorred
if proxy widget has <a class="link" href="GtkActivatable.html#GtkActivatable--use-action-appearance" title="The “use-action-appearance” property"><span class="type">“use-action-appearance”</span></a> property set to
<code class="literal">TRUE</code>.</p>
<p>When the proxy is activated, it should activate its action.</p>
</div>
<div class="refsect1">
<a name="GtkAction.functions_details"></a><h2>Functions</h2>
<div class="refsect2">
<a name="gtk-action-new"></a><h3>gtk_action_new ()</h3>
<pre class="programlisting"><a class="link" href="GtkAction.html" title="GtkAction"><span class="returnvalue">GtkAction</span></a> *
gtk_action_new (<em class="parameter"><code>const <span class="type">gchar</span> *name</code></em>,
                <em class="parameter"><code>const <span class="type">gchar</span> *label</code></em>,
                <em class="parameter"><code>const <span class="type">gchar</span> *tooltip</code></em>,
                <em class="parameter"><code>const <span class="type">gchar</span> *stock_id</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_action_new</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
<p>Use <span class="type">GAction</span> instead, associating it to a widget with
<a class="link" href="GtkActionable.html" title="GtkActionable"><span class="type">GtkActionable</span></a> or creating a <a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> with <a class="link" href="GtkMenu.html#gtk-menu-new-from-model" title="gtk_menu_new_from_model ()"><code class="function">gtk_menu_new_from_model()</code></a></p>
</div>
<p>Creates a new <a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a> object. To add the action to a
<a class="link" href="GtkActionGroup.html" title="GtkActionGroup"><span class="type">GtkActionGroup</span></a> and set the accelerator for the action,
call <a class="link" href="GtkActionGroup.html#gtk-action-group-add-action-with-accel" title="gtk_action_group_add_action_with_accel ()"><code class="function">gtk_action_group_add_action_with_accel()</code></a>.
See the <a class="link" href="GtkUIManager.html#XML-UI" title="UI Definitions">UI Definition section</a> for information on allowed action
names.</p>
<div class="refsect3">
<a name="gtk-action-new.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>name</p></td>
<td class="parameter_description"><p>A unique name for the action</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>label</p></td>
<td class="parameter_description"><p>the label displayed in menu items and on buttons,
or <code class="literal">NULL</code>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>tooltip</p></td>
<td class="parameter_description"><p>a tooltip for the action, or <code class="literal">NULL</code>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
<tr>
<td class="parameter_name"><p>stock_id</p></td>
<td class="parameter_description"><p>the stock icon to display in widgets representing
the action, or <code class="literal">NULL</code>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-action-new.returns"></a><h4>Returns</h4>
<p> a new <a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a></p>
</div>
<p class="since">Since: 2.4</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-action-get-name"></a><h3>gtk_action_get_name ()</h3>
<pre class="programlisting">const <span class="returnvalue">gchar</span> *
gtk_action_get_name (<em class="parameter"><code><a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a> *action</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_action_get_name</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
<p>Use <code class="function">g_action_get_name()</code> on a <span class="type">GAction</span> instead</p>
</div>
<p>Returns the name of the action.</p>
<div class="refsect3">
<a name="gtk-action-get-name.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>action</p></td>
<td class="parameter_description"><p>the action object</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-action-get-name.returns"></a><h4>Returns</h4>
<p> the name of the action. The string belongs to GTK+ and should not
be freed.</p>
</div>
<p class="since">Since: 2.4</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-action-is-sensitive"></a><h3>gtk_action_is_sensitive ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gtk_action_is_sensitive (<em class="parameter"><code><a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a> *action</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_action_is_sensitive</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
<p>Use <code class="function">g_action_get_enabled()</code> on a <span class="type">GAction</span>
instead</p>
</div>
<p>Returns whether the action is effectively sensitive.</p>
<div class="refsect3">
<a name="gtk-action-is-sensitive.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>action</p></td>
<td class="parameter_description"><p>the action object</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-action-is-sensitive.returns"></a><h4>Returns</h4>
<p> <code class="literal">TRUE</code> if the action and its associated action group
are both sensitive.</p>
</div>
<p class="since">Since: 2.4</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-action-get-sensitive"></a><h3>gtk_action_get_sensitive ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gtk_action_get_sensitive (<em class="parameter"><code><a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a> *action</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_action_get_sensitive</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
<p>Use <code class="function">g_action_get_enabled()</code> on a <span class="type">GAction</span>
instead</p>
</div>
<p>Returns whether the action itself is sensitive. Note that this doesn’t 
necessarily mean effective sensitivity. See <a class="link" href="GtkAction.html#gtk-action-is-sensitive" title="gtk_action_is_sensitive ()"><code class="function">gtk_action_is_sensitive()</code></a> 
for that.</p>
<div class="refsect3">
<a name="gtk-action-get-sensitive.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>action</p></td>
<td class="parameter_description"><p>the action object</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-action-get-sensitive.returns"></a><h4>Returns</h4>
<p> <code class="literal">TRUE</code> if the action itself is sensitive.</p>
</div>
<p class="since">Since: 2.4</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-action-set-sensitive"></a><h3>gtk_action_set_sensitive ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_action_set_sensitive (<em class="parameter"><code><a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a> *action</code></em>,
                          <em class="parameter"><code><span class="type">gboolean</span> sensitive</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_action_set_sensitive</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
<p>Use <code class="function">g_simple_action_set_enabled()</code> on a <span class="type">GSimpleAction</span>
instead</p>
</div>
<p>Sets the :sensitive property of the action to <em class="parameter"><code>sensitive</code></em>
. Note that 
this doesn’t necessarily mean effective sensitivity. See 
<a class="link" href="GtkAction.html#gtk-action-is-sensitive" title="gtk_action_is_sensitive ()"><code class="function">gtk_action_is_sensitive()</code></a> 
for that.</p>
<div class="refsect3">
<a name="gtk-action-set-sensitive.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>action</p></td>
<td class="parameter_description"><p>the action object</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>sensitive</p></td>
<td class="parameter_description"><p><code class="literal">TRUE</code> to make the action sensitive</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: 2.6</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-action-is-visible"></a><h3>gtk_action_is_visible ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gtk_action_is_visible (<em class="parameter"><code><a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a> *action</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_action_is_visible</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
<p>Use <span class="type">GAction</span> instead, and control and monitor the state of
<a class="link" href="GtkActionable.html" title="GtkActionable"><span class="type">GtkActionable</span></a> widgets directly</p>
</div>
<p>Returns whether the action is effectively visible.</p>
<div class="refsect3">
<a name="gtk-action-is-visible.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>action</p></td>
<td class="parameter_description"><p>the action object</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-action-is-visible.returns"></a><h4>Returns</h4>
<p> <code class="literal">TRUE</code> if the action and its associated action group
are both visible.</p>
</div>
<p class="since">Since: 2.4</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-action-get-visible"></a><h3>gtk_action_get_visible ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gtk_action_get_visible (<em class="parameter"><code><a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a> *action</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_action_get_visible</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
<p>Use <span class="type">GAction</span> instead, and control and monitor the state of
<a class="link" href="GtkActionable.html" title="GtkActionable"><span class="type">GtkActionable</span></a> widgets directly</p>
</div>
<p>Returns whether the action itself is visible. Note that this doesn’t 
necessarily mean effective visibility. See <a class="link" href="GtkAction.html#gtk-action-is-sensitive" title="gtk_action_is_sensitive ()"><code class="function">gtk_action_is_sensitive()</code></a> 
for that.</p>
<div class="refsect3">
<a name="gtk-action-get-visible.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>action</p></td>
<td class="parameter_description"><p>the action object</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-action-get-visible.returns"></a><h4>Returns</h4>
<p> <code class="literal">TRUE</code> if the action itself is visible.</p>
</div>
<p class="since">Since: 2.4</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-action-set-visible"></a><h3>gtk_action_set_visible ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_action_set_visible (<em class="parameter"><code><a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a> *action</code></em>,
                        <em class="parameter"><code><span class="type">gboolean</span> visible</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_action_set_visible</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
<p>Use <span class="type">GAction</span> instead, and control and monitor the state of
<a class="link" href="GtkActionable.html" title="GtkActionable"><span class="type">GtkActionable</span></a> widgets directly</p>
</div>
<p>Sets the :visible property of the action to <em class="parameter"><code>visible</code></em>
. Note that 
this doesn’t necessarily mean effective visibility. See 
<a class="link" href="GtkAction.html#gtk-action-is-visible" title="gtk_action_is_visible ()"><code class="function">gtk_action_is_visible()</code></a> 
for that.</p>
<div class="refsect3">
<a name="gtk-action-set-visible.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>action</p></td>
<td class="parameter_description"><p>the action object</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>visible</p></td>
<td class="parameter_description"><p><code class="literal">TRUE</code> to make the action visible</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: 2.6</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-action-activate"></a><h3>gtk_action_activate ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_action_activate (<em class="parameter"><code><a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a> *action</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_action_activate</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
<p>Use <code class="function">g_action_group_activate_action()</code> on a <span class="type">GAction</span> instead</p>
</div>
<p>Emits the “activate” signal on the specified action, if it isn't
insensitive. This gets called by the proxy widgets when they get 
activated.</p>
<p>It can also be used to manually activate an action.</p>
<div class="refsect3">
<a name="gtk-action-activate.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>action</p></td>
<td class="parameter_description"><p>the action object</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<p class="since">Since: 2.4</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-action-create-icon"></a><h3>gtk_action_create_icon ()</h3>
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *
gtk_action_create_icon (<em class="parameter"><code><a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a> *action</code></em>,
                        <em class="parameter"><code><a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize"><span class="type">GtkIconSize</span></a> icon_size</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_action_create_icon</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
<p>Use <code class="function">g_menu_item_set_icon()</code> to set an icon on a <span class="type">GMenuItem</span>,
or <a class="link" href="GtkContainer.html#gtk-container-add" title="gtk_container_add ()"><code class="function">gtk_container_add()</code></a> to add a <a class="link" href="GtkImage.html" title="GtkImage"><span class="type">GtkImage</span></a> to a <a class="link" href="GtkButton.html" title="GtkButton"><span class="type">GtkButton</span></a></p>
</div>
<p>This function is intended for use by action implementations to
create icons displayed in the proxy widgets.</p>
<div class="refsect3">
<a name="gtk-action-create-icon.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>action</p></td>
<td class="parameter_description"><p>the action object</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>icon_size</p></td>
<td class="parameter_description"><p>the size of the icon (<a class="link" href="gtk3-Themeable-Stock-Images.html#GtkIconSize" title="enum GtkIconSize"><span class="type">GtkIconSize</span></a>) that should
be created. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="Override the parsed C type with given type."><span class="acronym">type</span></acronym> int]</span></td>
</tr>
</tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-action-create-icon.returns"></a><h4>Returns</h4>
<p>a widget that displays the icon for this action. </p>
<p><span class="annotation">[<acronym title="The data is owned by the callee, which is responsible of freeing it."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
<p class="since">Since: 2.4</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-action-create-menu-item"></a><h3>gtk_action_create_menu_item ()</h3>
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *
gtk_action_create_menu_item (<em class="parameter"><code><a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a> *action</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_action_create_menu_item</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
<p>Use <code class="function">g_menu_item_new()</code> and associate it with a <span class="type">GAction</span>
instead.</p>
</div>
<p>Creates a menu item widget that proxies for the given action.</p>
<div class="refsect3">
<a name="gtk-action-create-menu-item.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>action</p></td>
<td class="parameter_description"><p>the action object</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-action-create-menu-item.returns"></a><h4>Returns</h4>
<p>a menu item connected to the action. </p>
<p><span class="annotation">[<acronym title="The data is owned by the callee, which is responsible of freeing it."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
<p class="since">Since: 2.4</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-action-create-tool-item"></a><h3>gtk_action_create_tool_item ()</h3>
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *
gtk_action_create_tool_item (<em class="parameter"><code><a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a> *action</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_action_create_tool_item</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
<p>Use a <a class="link" href="GtkToolItem.html" title="GtkToolItem"><span class="type">GtkToolItem</span></a> and associate it with a <span class="type">GAction</span> using
<a class="link" href="GtkActionable.html#gtk-actionable-set-action-name" title="gtk_actionable_set_action_name ()"><code class="function">gtk_actionable_set_action_name()</code></a> instead</p>
</div>
<p>Creates a toolbar item widget that proxies for the given action.</p>
<div class="refsect3">
<a name="gtk-action-create-tool-item.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>action</p></td>
<td class="parameter_description"><p>the action object</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-action-create-tool-item.returns"></a><h4>Returns</h4>
<p>a toolbar item connected to the action. </p>
<p><span class="annotation">[<acronym title="The data is owned by the callee, which is responsible of freeing it."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
<p class="since">Since: 2.4</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-action-create-menu"></a><h3>gtk_action_create_menu ()</h3>
<pre class="programlisting"><a class="link" href="GtkWidget.html" title="GtkWidget"><span class="returnvalue">GtkWidget</span></a> *
gtk_action_create_menu (<em class="parameter"><code><a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a> *action</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_action_create_menu</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
<p>Use <span class="type">GAction</span> and <span class="type">GMenuModel</span> instead, and create a
<a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> with <a class="link" href="GtkMenu.html#gtk-menu-new-from-model" title="gtk_menu_new_from_model ()"><code class="function">gtk_menu_new_from_model()</code></a></p>
</div>
<p>If <em class="parameter"><code>action</code></em>
 provides a <a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> widget as a submenu for the menu
item or the toolbar item it creates, this function returns an
instance of that menu.</p>
<div class="refsect3">
<a name="gtk-action-create-menu.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>action</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-action-create-menu.returns"></a><h4>Returns</h4>
<p>the menu item provided by the
action, or <code class="literal">NULL</code>. </p>
<p><span class="annotation">[<acronym title="The data is owned by the callee, which is responsible of freeing it."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
<p class="since">Since: 2.12</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-action-get-proxies"></a><h3>gtk_action_get_proxies ()</h3>
<pre class="programlisting"><span class="returnvalue">GSList</span> *
gtk_action_get_proxies (<em class="parameter"><code><a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a> *action</code></em>);</pre>
<div class="warning"><p><code class="literal">gtk_action_get_proxies</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p></div>
<p>Returns the proxy widgets for an action.
See also <a class="link" href="GtkActivatable.html#gtk-activatable-get-related-action" title="gtk_activatable_get_related_action ()"><code class="function">gtk_activatable_get_related_action()</code></a>.</p>
<div class="refsect3">
<a name="gtk-action-get-proxies.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>action</p></td>
<td class="parameter_description"><p>the action object</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-action-get-proxies.returns"></a><h4>Returns</h4>
<p>a <span class="type">GSList</span> of proxy widgets. The list is owned by GTK+
and must not be modified. </p>
<p><span class="annotation">[<acronym title="Generics and defining elements of containers and arrays."><span class="acronym">element-type</span></acronym> GtkWidget][<acronym title="The data is owned by the callee, which is responsible of freeing it."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
<p class="since">Since: 2.4</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-action-connect-accelerator"></a><h3>gtk_action_connect_accelerator ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_action_connect_accelerator (<em class="parameter"><code><a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a> *action</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_action_connect_accelerator</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
<p>Use <span class="type">GAction</span> and the accelerator group on an associated
<a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> instead</p>
</div>
<p>Installs the accelerator for <em class="parameter"><code>action</code></em>
 if <em class="parameter"><code>action</code></em>
 has an
accel path and group. See <a class="link" href="GtkAction.html#gtk-action-set-accel-path" title="gtk_action_set_accel_path ()"><code class="function">gtk_action_set_accel_path()</code></a> and 
<a class="link" href="GtkAction.html#gtk-action-set-accel-group" title="gtk_action_set_accel_group ()"><code class="function">gtk_action_set_accel_group()</code></a></p>
<p>Since multiple proxies may independently trigger the installation
of the accelerator, the <em class="parameter"><code>action</code></em>
 counts the number of times this
function has been called and doesn’t remove the accelerator until
<a class="link" href="GtkAction.html#gtk-action-disconnect-accelerator" title="gtk_action_disconnect_accelerator ()"><code class="function">gtk_action_disconnect_accelerator()</code></a> has been called as many times.</p>
<div class="refsect3">
<a name="gtk-action-connect-accelerator.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>action</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<p class="since">Since: 2.4</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-action-disconnect-accelerator"></a><h3>gtk_action_disconnect_accelerator ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_action_disconnect_accelerator (<em class="parameter"><code><a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a> *action</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_action_disconnect_accelerator</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
<p>Use <span class="type">GAction</span> and the accelerator group on an associated
<a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> instead</p>
</div>
<p>Undoes the effect of one call to <a class="link" href="GtkAction.html#gtk-action-connect-accelerator" title="gtk_action_connect_accelerator ()"><code class="function">gtk_action_connect_accelerator()</code></a>.</p>
<div class="refsect3">
<a name="gtk-action-disconnect-accelerator.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>action</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<p class="since">Since: 2.4</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-action-block-activate"></a><h3>gtk_action_block_activate ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_action_block_activate (<em class="parameter"><code><a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a> *action</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_action_block_activate</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
<p>Use <code class="function">g_simple_action_set_enabled()</code> to disable the
<span class="type">GSimpleAction</span> instead</p>
</div>
<p>Disable activation signals from the action </p>
<p>This is needed when updating the state of your proxy
<a class="link" href="GtkActivatable.html" title="GtkActivatable"><span class="type">GtkActivatable</span></a> widget could result in calling <a class="link" href="GtkAction.html#gtk-action-activate" title="gtk_action_activate ()"><code class="function">gtk_action_activate()</code></a>,
this is a convenience function to avoid recursing in those
cases (updating toggle state for instance).</p>
<div class="refsect3">
<a name="gtk-action-block-activate.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>action</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<p class="since">Since: 2.16</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-action-unblock-activate"></a><h3>gtk_action_unblock_activate ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_action_unblock_activate (<em class="parameter"><code><a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a> *action</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_action_unblock_activate</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
<p>Use <code class="function">g_simple_action_set_enabled()</code> to enable the
<span class="type">GSimpleAction</span> instead</p>
</div>
<p>Reenable activation signals from the action</p>
<div class="refsect3">
<a name="gtk-action-unblock-activate.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>action</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<p class="since">Since: 2.16</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-action-get-always-show-image"></a><h3>gtk_action_get_always_show_image ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gtk_action_get_always_show_image (<em class="parameter"><code><a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a> *action</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_action_get_always_show_image</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
<p>Use <code class="function">g_menu_item_get_attribute_value()</code> on a <span class="type">GMenuItem</span>
instead</p>
</div>
<p>Returns whether <em class="parameter"><code>action</code></em>
's menu item proxies will always
show their image, if available.</p>
<div class="refsect3">
<a name="gtk-action-get-always-show-image.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>action</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-action-get-always-show-image.returns"></a><h4>Returns</h4>
<p> <code class="literal">TRUE</code> if the menu item proxies will always show their image</p>
</div>
<p class="since">Since: 2.20</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-action-set-always-show-image"></a><h3>gtk_action_set_always_show_image ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_action_set_always_show_image (<em class="parameter"><code><a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a> *action</code></em>,
                                  <em class="parameter"><code><span class="type">gboolean</span> always_show</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_action_set_always_show_image</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
<p>Use <code class="function">g_menu_item_set_icon()</code> on a <span class="type">GMenuItem</span> instead, if the
item should have an image</p>
</div>
<p>Sets whether <em class="parameter"><code>action</code></em>
's menu item proxies will ignore the
<a class="link" href="GtkSettings.html#GtkSettings--gtk-menu-images" title="The “gtk-menu-images” property"><span class="type">“gtk-menu-images”</span></a> setting and always show their image, if available.</p>
<p>Use this if the menu item would be useless or hard to use
without their image.</p>
<div class="refsect3">
<a name="gtk-action-set-always-show-image.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>action</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>always_show</p></td>
<td class="parameter_description"><p><code class="literal">TRUE</code> if menuitem proxies should always show their image</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: 2.20</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-action-get-accel-path"></a><h3>gtk_action_get_accel_path ()</h3>
<pre class="programlisting">const <span class="returnvalue">gchar</span> *
gtk_action_get_accel_path (<em class="parameter"><code><a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a> *action</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_action_get_accel_path</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
<p>Use <span class="type">GAction</span> and the accelerator path on an associated
<a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> instead</p>
</div>
<p>Returns the accel path for this action.</p>
<div class="refsect3">
<a name="gtk-action-get-accel-path.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>action</p></td>
<td class="parameter_description"><p>the action object</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-action-get-accel-path.returns"></a><h4>Returns</h4>
<p> the accel path for this action, or <code class="literal">NULL</code>
if none is set. The returned string is owned by GTK+
and must not be freed or modified.</p>
</div>
<p class="since">Since: 2.6</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-action-set-accel-path"></a><h3>gtk_action_set_accel_path ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_action_set_accel_path (<em class="parameter"><code><a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a> *action</code></em>,
                           <em class="parameter"><code>const <span class="type">gchar</span> *accel_path</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_action_set_accel_path</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
<p>Use <span class="type">GAction</span> and the accelerator path on an associated
<a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> instead</p>
</div>
<p>Sets the accel path for this action.  All proxy widgets associated
with the action will have this accel path, so that their
accelerators are consistent.</p>
<p>Note that <em class="parameter"><code>accel_path</code></em>
 string will be stored in a <span class="type">GQuark</span>. Therefore, if you
pass a static string, you can save some memory by interning it first with 
<code class="function">g_intern_static_string()</code>.</p>
<div class="refsect3">
<a name="gtk-action-set-accel-path.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>action</p></td>
<td class="parameter_description"><p>the action object</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>accel_path</p></td>
<td class="parameter_description"><p>the accelerator path</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: 2.4</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-action-get-accel-closure"></a><h3>gtk_action_get_accel_closure ()</h3>
<pre class="programlisting"><span class="returnvalue">GClosure</span> *
gtk_action_get_accel_closure (<em class="parameter"><code><a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a> *action</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_action_get_accel_closure</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
<p>Use <span class="type">GAction</span> and <a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> instead, which have no
equivalent for getting the accel closure</p>
</div>
<p>Returns the accel closure for this action.</p>
<div class="refsect3">
<a name="gtk-action-get-accel-closure.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>action</p></td>
<td class="parameter_description"><p>the action object</p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-action-get-accel-closure.returns"></a><h4>Returns</h4>
<p>the accel closure for this action. The
returned closure is owned by GTK+ and must not be unreffed
or modified. </p>
<p><span class="annotation">[<acronym title="The data is owned by the callee, which is responsible of freeing it."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
<p class="since">Since: 2.8</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-action-set-accel-group"></a><h3>gtk_action_set_accel_group ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_action_set_accel_group (<em class="parameter"><code><a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a> *action</code></em>,
                            <em class="parameter"><code><a class="link" href="gtk3-Keyboard-Accelerators.html#GtkAccelGroup"><span class="type">GtkAccelGroup</span></a> *accel_group</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_action_set_accel_group</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
<p>Use <span class="type">GAction</span> and the accelerator group on an associated
<a class="link" href="GtkMenu.html" title="GtkMenu"><span class="type">GtkMenu</span></a> instead</p>
</div>
<p>Sets the <a class="link" href="gtk3-Keyboard-Accelerators.html#GtkAccelGroup"><span class="type">GtkAccelGroup</span></a> in which the accelerator for this action
will be installed.</p>
<div class="refsect3">
<a name="gtk-action-set-accel-group.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>action</p></td>
<td class="parameter_description"><p>the action object</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>accel_group</p></td>
<td class="parameter_description"><p>a <a class="link" href="gtk3-Keyboard-Accelerators.html#GtkAccelGroup"><span class="type">GtkAccelGroup</span></a> or <code class="literal">NULL</code>. </p></td>
<td class="parameter_annotations"><span class="annotation">[<acronym title="NULL is OK, both for passing and for returning."><span class="acronym">allow-none</span></acronym>]</span></td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: 2.4</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-action-set-label"></a><h3>gtk_action_set_label ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_action_set_label (<em class="parameter"><code><a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a> *action</code></em>,
                      <em class="parameter"><code>const <span class="type">gchar</span> *label</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_action_set_label</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
<p>Use <span class="type">GAction</span> instead, and set a label on a menu item with
<code class="function">g_menu_item_set_label()</code>. For <a class="link" href="GtkActionable.html" title="GtkActionable"><span class="type">GtkActionable</span></a> widgets, use the widget-specific
API to set a label</p>
</div>
<p>Sets the label of <em class="parameter"><code>action</code></em>
.</p>
<div class="refsect3">
<a name="gtk-action-set-label.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>action</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>label</p></td>
<td class="parameter_description"><p>the label text to set</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: 2.16</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-action-get-label"></a><h3>gtk_action_get_label ()</h3>
<pre class="programlisting">const <span class="returnvalue">gchar</span> *
gtk_action_get_label (<em class="parameter"><code><a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a> *action</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_action_get_label</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
<p>Use <span class="type">GAction</span> instead, and get a label from a menu item
with <code class="function">g_menu_item_get_attribute_value()</code>. For <a class="link" href="GtkActionable.html" title="GtkActionable"><span class="type">GtkActionable</span></a> widgets, use the
widget-specific API to get a label</p>
</div>
<p>Gets the label text of <em class="parameter"><code>action</code></em>
.</p>
<div class="refsect3">
<a name="gtk-action-get-label.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>action</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-action-get-label.returns"></a><h4>Returns</h4>
<p> the label text</p>
</div>
<p class="since">Since: 2.16</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-action-set-short-label"></a><h3>gtk_action_set_short_label ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_action_set_short_label (<em class="parameter"><code><a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a> *action</code></em>,
                            <em class="parameter"><code>const <span class="type">gchar</span> *short_label</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_action_set_short_label</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
<p>Use <span class="type">GAction</span> instead, which has no equivalent of short
labels</p>
</div>
<p>Sets a shorter label text on <em class="parameter"><code>action</code></em>
.</p>
<div class="refsect3">
<a name="gtk-action-set-short-label.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>action</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>short_label</p></td>
<td class="parameter_description"><p>the label text to set</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: 2.16</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-action-get-short-label"></a><h3>gtk_action_get_short_label ()</h3>
<pre class="programlisting">const <span class="returnvalue">gchar</span> *
gtk_action_get_short_label (<em class="parameter"><code><a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a> *action</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_action_get_short_label</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
<p>Use <span class="type">GAction</span> instead, which has no equivalent of short
labels</p>
</div>
<p>Gets the short label text of <em class="parameter"><code>action</code></em>
.</p>
<div class="refsect3">
<a name="gtk-action-get-short-label.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>action</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-action-get-short-label.returns"></a><h4>Returns</h4>
<p> the short label text.</p>
</div>
<p class="since">Since: 2.16</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-action-set-tooltip"></a><h3>gtk_action_set_tooltip ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_action_set_tooltip (<em class="parameter"><code><a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a> *action</code></em>,
                        <em class="parameter"><code>const <span class="type">gchar</span> *tooltip</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_action_set_tooltip</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
<p>Use <span class="type">GAction</span> instead, and set tooltips on associated
<a class="link" href="GtkActionable.html" title="GtkActionable"><span class="type">GtkActionable</span></a> widgets with <a class="link" href="GtkWidget.html#gtk-widget-set-tooltip-text" title="gtk_widget_set_tooltip_text ()"><code class="function">gtk_widget_set_tooltip_text()</code></a></p>
</div>
<p>Sets the tooltip text on <em class="parameter"><code>action</code></em>
</p>
<div class="refsect3">
<a name="gtk-action-set-tooltip.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>action</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>tooltip</p></td>
<td class="parameter_description"><p>the tooltip text</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: 2.16</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-action-get-tooltip"></a><h3>gtk_action_get_tooltip ()</h3>
<pre class="programlisting">const <span class="returnvalue">gchar</span> *
gtk_action_get_tooltip (<em class="parameter"><code><a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a> *action</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_action_get_tooltip</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
<p>Use <span class="type">GAction</span> instead, and get tooltips from associated
<a class="link" href="GtkActionable.html" title="GtkActionable"><span class="type">GtkActionable</span></a> widgets with <a class="link" href="GtkWidget.html#gtk-widget-get-tooltip-text" title="gtk_widget_get_tooltip_text ()"><code class="function">gtk_widget_get_tooltip_text()</code></a></p>
</div>
<p>Gets the tooltip text of <em class="parameter"><code>action</code></em>
.</p>
<div class="refsect3">
<a name="gtk-action-get-tooltip.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>action</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-action-get-tooltip.returns"></a><h4>Returns</h4>
<p> the tooltip text</p>
</div>
<p class="since">Since: 2.16</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-action-set-stock-id"></a><h3>gtk_action_set_stock_id ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_action_set_stock_id (<em class="parameter"><code><a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a> *action</code></em>,
                         <em class="parameter"><code>const <span class="type">gchar</span> *stock_id</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_action_set_stock_id</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
<p>Use <span class="type">GAction</span> instead, which has no equivalent of stock
items</p>
</div>
<p>Sets the stock id on <em class="parameter"><code>action</code></em>
</p>
<div class="refsect3">
<a name="gtk-action-set-stock-id.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>action</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>stock_id</p></td>
<td class="parameter_description"><p>the stock id</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: 2.16</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-action-get-stock-id"></a><h3>gtk_action_get_stock_id ()</h3>
<pre class="programlisting">const <span class="returnvalue">gchar</span> *
gtk_action_get_stock_id (<em class="parameter"><code><a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a> *action</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_action_get_stock_id</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
<p>Use <span class="type">GAction</span> instead, which has no equivalent of stock
items</p>
</div>
<p>Gets the stock id of <em class="parameter"><code>action</code></em>
.</p>
<div class="refsect3">
<a name="gtk-action-get-stock-id.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>action</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-action-get-stock-id.returns"></a><h4>Returns</h4>
<p> the stock id</p>
</div>
<p class="since">Since: 2.16</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-action-set-gicon"></a><h3>gtk_action_set_gicon ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_action_set_gicon (<em class="parameter"><code><a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a> *action</code></em>,
                      <em class="parameter"><code><span class="type">GIcon</span> *icon</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_action_set_gicon</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
<p>Use <span class="type">GAction</span> instead, and <code class="function">g_menu_item_set_icon()</code> to set an
icon on a <span class="type">GMenuItem</span> associated with a <span class="type">GAction</span>, or <a class="link" href="GtkContainer.html#gtk-container-add" title="gtk_container_add ()"><code class="function">gtk_container_add()</code></a> to
add a <a class="link" href="GtkImage.html" title="GtkImage"><span class="type">GtkImage</span></a> to a <a class="link" href="GtkButton.html" title="GtkButton"><span class="type">GtkButton</span></a></p>
</div>
<p>Sets the icon of <em class="parameter"><code>action</code></em>
.</p>
<div class="refsect3">
<a name="gtk-action-set-gicon.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>action</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>icon</p></td>
<td class="parameter_description"><p>the <span class="type">GIcon</span> to set</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: 2.16</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-action-get-gicon"></a><h3>gtk_action_get_gicon ()</h3>
<pre class="programlisting"><span class="returnvalue">GIcon</span> *
gtk_action_get_gicon (<em class="parameter"><code><a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a> *action</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_action_get_gicon</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
<p>Use <span class="type">GAction</span> instead, and
<code class="function">g_menu_item_get_attribute_value()</code> to get an icon from a <span class="type">GMenuItem</span>
associated with a <span class="type">GAction</span></p>
</div>
<p>Gets the gicon of <em class="parameter"><code>action</code></em>
.</p>
<div class="refsect3">
<a name="gtk-action-get-gicon.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>action</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-action-get-gicon.returns"></a><h4>Returns</h4>
<p>The action’s <span class="type">GIcon</span> if one is set. </p>
<p><span class="annotation">[<acronym title="The data is owned by the callee, which is responsible of freeing it."><span class="acronym">transfer none</span></acronym>]</span></p>
</div>
<p class="since">Since: 2.16</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-action-set-icon-name"></a><h3>gtk_action_set_icon_name ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_action_set_icon_name (<em class="parameter"><code><a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a> *action</code></em>,
                          <em class="parameter"><code>const <span class="type">gchar</span> *icon_name</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_action_set_icon_name</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
<p>Use <span class="type">GAction</span> instead, and <code class="function">g_menu_item_set_icon()</code> to set an
icon on a <span class="type">GMenuItem</span> associated with a <span class="type">GAction</span>, or <a class="link" href="GtkContainer.html#gtk-container-add" title="gtk_container_add ()"><code class="function">gtk_container_add()</code></a> to
add a <a class="link" href="GtkImage.html" title="GtkImage"><span class="type">GtkImage</span></a> to a <a class="link" href="GtkButton.html" title="GtkButton"><span class="type">GtkButton</span></a></p>
</div>
<p>Sets the icon name on <em class="parameter"><code>action</code></em>
</p>
<div class="refsect3">
<a name="gtk-action-set-icon-name.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>action</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>icon_name</p></td>
<td class="parameter_description"><p>the icon name to set</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: 2.16</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-action-get-icon-name"></a><h3>gtk_action_get_icon_name ()</h3>
<pre class="programlisting">const <span class="returnvalue">gchar</span> *
gtk_action_get_icon_name (<em class="parameter"><code><a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a> *action</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_action_get_icon_name</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
<p>Use <span class="type">GAction</span> instead, and
<code class="function">g_menu_item_get_attribute_value()</code> to get an icon from a <span class="type">GMenuItem</span>
associated with a <span class="type">GAction</span></p>
</div>
<p>Gets the icon name of <em class="parameter"><code>action</code></em>
.</p>
<div class="refsect3">
<a name="gtk-action-get-icon-name.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>action</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-action-get-icon-name.returns"></a><h4>Returns</h4>
<p> the icon name</p>
</div>
<p class="since">Since: 2.16</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-action-set-visible-horizontal"></a><h3>gtk_action_set_visible_horizontal ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_action_set_visible_horizontal (<em class="parameter"><code><a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a> *action</code></em>,
                                   <em class="parameter"><code><span class="type">gboolean</span> visible_horizontal</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_action_set_visible_horizontal</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
<p>Use <span class="type">GAction</span> instead, and control and monitor the
visibility of associated widgets and menu items directly</p>
</div>
<p>Sets whether <em class="parameter"><code>action</code></em>
 is visible when horizontal</p>
<div class="refsect3">
<a name="gtk-action-set-visible-horizontal.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>action</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>visible_horizontal</p></td>
<td class="parameter_description"><p>whether the action is visible horizontally</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: 2.16</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-action-get-visible-horizontal"></a><h3>gtk_action_get_visible_horizontal ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gtk_action_get_visible_horizontal (<em class="parameter"><code><a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a> *action</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_action_get_visible_horizontal</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
<p>Use <span class="type">GAction</span> instead, and control and monitor the
visibility of associated widgets and menu items directly</p>
</div>
<p>Checks whether <em class="parameter"><code>action</code></em>
 is visible when horizontal</p>
<div class="refsect3">
<a name="gtk-action-get-visible-horizontal.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>action</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-action-get-visible-horizontal.returns"></a><h4>Returns</h4>
<p> whether <em class="parameter"><code>action</code></em>
is visible when horizontal</p>
</div>
<p class="since">Since: 2.16</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-action-set-visible-vertical"></a><h3>gtk_action_set_visible_vertical ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_action_set_visible_vertical (<em class="parameter"><code><a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a> *action</code></em>,
                                 <em class="parameter"><code><span class="type">gboolean</span> visible_vertical</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_action_set_visible_vertical</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
<p>Use <span class="type">GAction</span> instead, and control and monitor the
visibility of associated widgets and menu items directly</p>
</div>
<p>Sets whether <em class="parameter"><code>action</code></em>
 is visible when vertical</p>
<div class="refsect3">
<a name="gtk-action-set-visible-vertical.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>action</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>visible_vertical</p></td>
<td class="parameter_description"><p>whether the action is visible vertically</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: 2.16</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-action-get-visible-vertical"></a><h3>gtk_action_get_visible_vertical ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gtk_action_get_visible_vertical (<em class="parameter"><code><a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a> *action</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_action_get_visible_vertical</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
<p>Use <span class="type">GAction</span> instead, and control and monitor the
visibility of associated widgets and menu items directly</p>
</div>
<p>Checks whether <em class="parameter"><code>action</code></em>
 is visible when horizontal</p>
<div class="refsect3">
<a name="gtk-action-get-visible-vertical.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>action</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-action-get-visible-vertical.returns"></a><h4>Returns</h4>
<p> whether <em class="parameter"><code>action</code></em>
is visible when horizontal</p>
</div>
<p class="since">Since: 2.16</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-action-set-is-important"></a><h3>gtk_action_set_is_important ()</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
gtk_action_set_is_important (<em class="parameter"><code><a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a> *action</code></em>,
                             <em class="parameter"><code><span class="type">gboolean</span> is_important</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_action_set_is_important</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
<p>Use <span class="type">GAction</span> instead, and control and monitor whether
labels are shown directly</p>
</div>
<p>Sets whether the action is important, this attribute is used
primarily by toolbar items to decide whether to show a label
or not.</p>
<div class="refsect3">
<a name="gtk-action-set-is-important.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>action</p></td>
<td class="parameter_description"><p>the action object</p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>is_important</p></td>
<td class="parameter_description"><p><code class="literal">TRUE</code> to make the action important</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p class="since">Since: 2.16</p>
</div>
<hr>
<div class="refsect2">
<a name="gtk-action-get-is-important"></a><h3>gtk_action_get_is_important ()</h3>
<pre class="programlisting"><span class="returnvalue">gboolean</span>
gtk_action_get_is_important (<em class="parameter"><code><a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a> *action</code></em>);</pre>
<div class="warning">
<p><code class="literal">gtk_action_get_is_important</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
<p>Use <span class="type">GAction</span> instead, and control and monitor whether
labels are shown directly</p>
</div>
<p>Checks whether <em class="parameter"><code>action</code></em>
 is important or not</p>
<div class="refsect3">
<a name="gtk-action-get-is-important.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody><tr>
<td class="parameter_name"><p>action</p></td>
<td class="parameter_description"><p>a <a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr></tbody>
</table></div>
</div>
<div class="refsect3">
<a name="gtk-action-get-is-important.returns"></a><h4>Returns</h4>
<p> whether <em class="parameter"><code>action</code></em>
is important</p>
</div>
<p class="since">Since: 2.16</p>
</div>
</div>
<div class="refsect1">
<a name="GtkAction.other_details"></a><h2>Types and Values</h2>
<div class="refsect2">
<a name="GtkAction-struct"></a><h3>struct GtkAction</h3>
<pre class="programlisting">struct GtkAction;</pre>
</div>
<hr>
<div class="refsect2">
<a name="GtkActionClass"></a><h3>struct GtkActionClass</h3>
<pre class="programlisting">struct GtkActionClass {
  GObjectClass parent_class;

  /* activation signal */
  void       (* activate)           (GtkAction    *action);
};
</pre>
<div class="refsect3">
<a name="GtkActionClass.members"></a><h4>Members</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="300px" class="struct_members_name">
<col class="struct_members_description">
<col width="200px" class="struct_members_annotations">
</colgroup>
<tbody><tr>
<td class="struct_member_name"><p><em class="structfield"><code><a name="GtkActionClass.activate"></a>activate</code></em> ()</p></td>
<td class="struct_member_description"><p>Signal emitted when the action is activated.</p></td>
<td class="struct_member_annotations"> </td>
</tr></tbody>
</table></div>
</div>
</div>
</div>
<div class="refsect1">
<a name="GtkAction.property-details"></a><h2>Property Details</h2>
<div class="refsect2">
<a name="GtkAction--action-group"></a><h3>The <code class="literal">“action-group”</code> property</h3>
<pre class="programlisting">  “action-group”             <a class="link" href="GtkActionGroup.html" title="GtkActionGroup"><span class="type">GtkActionGroup</span></a> *</pre>
<p>The GtkActionGroup this GtkAction is associated with, or NULL
(for internal use).</p>
<div class="warning">
<p><code class="literal">GtkAction:action-group</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
<p>Lookup the <span class="type">GAction</span> using <code class="function">g_action_map_lookup_action()</code>
instead</p>
</div>
<p>Owner: GtkAction</p>
<p>Flags: Read / Write</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkAction--always-show-image"></a><h3>The <code class="literal">“always-show-image”</code> property</h3>
<pre class="programlisting">  “always-show-image”        <span class="type">gboolean</span></pre>
<p>If <code class="literal">TRUE</code>, the action's menu item proxies will ignore the <a class="link" href="GtkSettings.html#GtkSettings--gtk-menu-images" title="The “gtk-menu-images” property"><span class="type">“gtk-menu-images”</span></a>

setting and always show their image, if available.</p>
<p>Use this property if the menu item would be useless or hard to use
without their image.</p>
<div class="warning">
<p><code class="literal">GtkAction:always-show-image</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
<p>There is no corresponding replacement when using
<span class="type">GAction</span></p>
</div>
<p>Owner: GtkAction</p>
<p>Flags: Read / Write / Construct</p>
<p>Default value: FALSE</p>
<p class="since">Since: 2.20</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkAction--gicon"></a><h3>The <code class="literal">“gicon”</code> property</h3>
<pre class="programlisting">  “gicon”                    <span class="type">GIcon</span> *</pre>
<p>The <span class="type">GIcon</span> displayed in the <a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a>.</p>
<p>Note that the stock icon is preferred, if the <a class="link" href="GtkAction.html#GtkAction--stock-id" title="The “stock-id” property"><span class="type">“stock-id”</span></a>

property holds the id of an existing stock icon.</p>
<p>This is an appearance property and thus only applies if

<a class="link" href="GtkActivatable.html#GtkActivatable--use-action-appearance" title="The “use-action-appearance” property"><span class="type">“use-action-appearance”</span></a> is <code class="literal">TRUE</code>.</p>
<div class="warning">
<p><code class="literal">GtkAction:gicon</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
<p>Use the "icon" attribute on a <span class="type">GMenuItem</span> instead</p>
</div>
<p>Owner: GtkAction</p>
<p>Flags: Read / Write</p>
<p class="since">Since: 2.16</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkAction--hide-if-empty"></a><h3>The <code class="literal">“hide-if-empty”</code> property</h3>
<pre class="programlisting">  “hide-if-empty”            <span class="type">gboolean</span></pre>
<p>When TRUE, empty menu proxies for this action are hidden.</p>
<div class="warning">
<p><code class="literal">GtkAction:hide-if-empty</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
<p>There is no corresponding replacement when using
<span class="type">GAction</span></p>
</div>
<p>Owner: GtkAction</p>
<p>Flags: Read / Write</p>
<p>Default value: TRUE</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkAction--icon-name"></a><h3>The <code class="literal">“icon-name”</code> property</h3>
<pre class="programlisting">  “icon-name”                <span class="type">char</span> *</pre>
<p>The name of the icon from the icon theme. </p>
<p>Note that the stock icon is preferred, if the <a class="link" href="GtkAction.html#GtkAction--stock-id" title="The “stock-id” property"><span class="type">“stock-id”</span></a>

property holds the id of an existing stock icon, and the <span class="type">GIcon</span> is
preferred if the <a class="link" href="GtkAction.html#GtkAction--gicon" title="The “gicon” property"><span class="type">“gicon”</span></a> property is set. </p>
<p>This is an appearance property and thus only applies if

<a class="link" href="GtkActivatable.html#GtkActivatable--use-action-appearance" title="The “use-action-appearance” property"><span class="type">“use-action-appearance”</span></a> is <code class="literal">TRUE</code>.</p>
<div class="warning">
<p><code class="literal">GtkAction:icon-name</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
<p>Use the "icon" attribute on a <span class="type">GMenuItem</span> instead</p>
</div>
<p>Owner: GtkAction</p>
<p>Flags: Read / Write</p>
<p>Default value: NULL</p>
<p class="since">Since: 2.10</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkAction--is-important"></a><h3>The <code class="literal">“is-important”</code> property</h3>
<pre class="programlisting">  “is-important”             <span class="type">gboolean</span></pre>
<p>Whether the action is considered important. When TRUE, toolitem
proxies for this action show text in GTK_TOOLBAR_BOTH_HORIZ mode.</p>
<div class="warning">
<p><code class="literal">GtkAction:is-important</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
<p>There is no corresponding replacement when using
<span class="type">GAction</span></p>
</div>
<p>Owner: GtkAction</p>
<p>Flags: Read / Write</p>
<p>Default value: FALSE</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkAction--label"></a><h3>The <code class="literal">“label”</code> property</h3>
<pre class="programlisting">  “label”                    <span class="type">char</span> *</pre>
<p>The label used for menu items and buttons that activate
this action. If the label is <code class="literal">NULL</code>, GTK+ uses the stock

label specified via the stock-id property.</p>
<p>This is an appearance property and thus only applies if

<a class="link" href="GtkActivatable.html#GtkActivatable--use-action-appearance" title="The “use-action-appearance” property"><span class="type">“use-action-appearance”</span></a> is <code class="literal">TRUE</code>.</p>
<div class="warning">
<p><code class="literal">GtkAction:label</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
<p>Use the "label" attribute on <span class="type">GMenuItem</span> instead</p>
</div>
<p>Owner: GtkAction</p>
<p>Flags: Read / Write</p>
<p>Default value: NULL</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkAction--name"></a><h3>The <code class="literal">“name”</code> property</h3>
<pre class="programlisting">  “name”                     <span class="type">char</span> *</pre>
<p>A unique name for the action.</p>
<div class="warning">
<p><code class="literal">GtkAction:name</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
<p>Use <span class="type">“name”</span> instead</p>
</div>
<p>Owner: GtkAction</p>
<p>Flags: Read / Write / Construct Only</p>
<p>Default value: NULL</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkAction--sensitive"></a><h3>The <code class="literal">“sensitive”</code> property</h3>
<pre class="programlisting">  “sensitive”                <span class="type">gboolean</span></pre>
<p>Whether the action is enabled.</p>
<div class="warning">
<p><code class="literal">GtkAction:sensitive</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
<p>Use <span class="type">“enabled”</span> and <span class="type">“enabled”</span>
instead</p>
</div>
<p>Owner: GtkAction</p>
<p>Flags: Read / Write</p>
<p>Default value: TRUE</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkAction--short-label"></a><h3>The <code class="literal">“short-label”</code> property</h3>
<pre class="programlisting">  “short-label”              <span class="type">char</span> *</pre>
<p>A shorter label that may be used on toolbar buttons.</p>
<p>This is an appearance property and thus only applies if

<a class="link" href="GtkActivatable.html#GtkActivatable--use-action-appearance" title="The “use-action-appearance” property"><span class="type">“use-action-appearance”</span></a> is <code class="literal">TRUE</code>.</p>
<div class="warning">
<p><code class="literal">GtkAction:short-label</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
<p>There is no corresponding replacement when using
<span class="type">GAction</span></p>
</div>
<p>Owner: GtkAction</p>
<p>Flags: Read / Write</p>
<p>Default value: NULL</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkAction--stock-id"></a><h3>The <code class="literal">“stock-id”</code> property</h3>
<pre class="programlisting">  “stock-id”                 <span class="type">char</span> *</pre>
<p>The stock icon displayed in widgets representing this action.</p>
<p>This is an appearance property and thus only applies if

<a class="link" href="GtkActivatable.html#GtkActivatable--use-action-appearance" title="The “use-action-appearance” property"><span class="type">“use-action-appearance”</span></a> is <code class="literal">TRUE</code>.</p>
<div class="warning">
<p><code class="literal">GtkAction:stock-id</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
<p>There is no corresponding replacement when using
<span class="type">GAction</span></p>
</div>
<p>Owner: GtkAction</p>
<p>Flags: Read / Write</p>
<p>Default value: NULL</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkAction--tooltip"></a><h3>The <code class="literal">“tooltip”</code> property</h3>
<pre class="programlisting">  “tooltip”                  <span class="type">char</span> *</pre>
<p>A tooltip for this action.</p>
<div class="warning">
<p><code class="literal">GtkAction:tooltip</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
<p>Use <a class="link" href="GtkWidget.html#gtk-widget-set-tooltip-text" title="gtk_widget_set_tooltip_text ()"><code class="function">gtk_widget_set_tooltip_text()</code></a> instead</p>
</div>
<p>Owner: GtkAction</p>
<p>Flags: Read / Write</p>
<p>Default value: NULL</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkAction--visible"></a><h3>The <code class="literal">“visible”</code> property</h3>
<pre class="programlisting">  “visible”                  <span class="type">gboolean</span></pre>
<p>Whether the action is visible.</p>
<div class="warning">
<p><code class="literal">GtkAction:visible</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
<p>There is no corresponding replacement when using
<span class="type">GAction</span></p>
</div>
<p>Owner: GtkAction</p>
<p>Flags: Read / Write</p>
<p>Default value: TRUE</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkAction--visible-horizontal"></a><h3>The <code class="literal">“visible-horizontal”</code> property</h3>
<pre class="programlisting">  “visible-horizontal”       <span class="type">gboolean</span></pre>
<p>Whether the toolbar item is visible when the toolbar is in a horizontal orientation.</p>
<div class="warning">
<p><code class="literal">GtkAction:visible-horizontal</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
<p>There is no corresponding replacement when using
<span class="type">GAction</span></p>
</div>
<p>Owner: GtkAction</p>
<p>Flags: Read / Write</p>
<p>Default value: TRUE</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkAction--visible-overflown"></a><h3>The <code class="literal">“visible-overflown”</code> property</h3>
<pre class="programlisting">  “visible-overflown”        <span class="type">gboolean</span></pre>
<p>When <code class="literal">TRUE</code>, toolitem proxies for this action are represented in the

toolbar overflow menu.</p>
<div class="warning">
<p><code class="literal">GtkAction:visible-overflown</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
<p>There is no corresponding replacement when using
<span class="type">GAction</span></p>
</div>
<p>Owner: GtkAction</p>
<p>Flags: Read / Write</p>
<p>Default value: TRUE</p>
<p class="since">Since: 2.6</p>
</div>
<hr>
<div class="refsect2">
<a name="GtkAction--visible-vertical"></a><h3>The <code class="literal">“visible-vertical”</code> property</h3>
<pre class="programlisting">  “visible-vertical”         <span class="type">gboolean</span></pre>
<p>Whether the toolbar item is visible when the toolbar is in a vertical orientation.</p>
<div class="warning">
<p><code class="literal">GtkAction:visible-vertical</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
<p>There is no corresponding replacement when using
<span class="type">GAction</span></p>
</div>
<p>Owner: GtkAction</p>
<p>Flags: Read / Write</p>
<p>Default value: TRUE</p>
</div>
</div>
<div class="refsect1">
<a name="GtkAction.signal-details"></a><h2>Signal Details</h2>
<div class="refsect2">
<a name="GtkAction-activate"></a><h3>The <code class="literal">“activate”</code> signal</h3>
<pre class="programlisting"><span class="returnvalue">void</span>
user_function (<a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a> *action,
               <span class="type">gpointer</span>   user_data)</pre>
<p>The "activate" signal is emitted when the action is activated.</p>
<div class="warning">
<p><code class="literal">GtkAction::activate</code> has been deprecated since version 3.10 and should not be used in newly-written code.</p>
<p>Use <span class="type">“activate”</span> instead</p>
</div>
<div class="refsect3">
<a name="GtkAction-activate.parameters"></a><h4>Parameters</h4>
<div class="informaltable"><table class="informaltable" width="100%" border="0">
<colgroup>
<col width="150px" class="parameters_name">
<col class="parameters_description">
<col width="200px" class="parameters_annotations">
</colgroup>
<tbody>
<tr>
<td class="parameter_name"><p>action</p></td>
<td class="parameter_description"><p>the <a class="link" href="GtkAction.html" title="GtkAction"><span class="type">GtkAction</span></a></p></td>
<td class="parameter_annotations"> </td>
</tr>
<tr>
<td class="parameter_name"><p>user_data</p></td>
<td class="parameter_description"><p>user data set when the signal handler was connected.</p></td>
<td class="parameter_annotations"> </td>
</tr>
</tbody>
</table></div>
</div>
<p>Flags: No Recursion</p>
<p class="since">Since: 2.4</p>
</div>
</div>
<div class="refsect1">
<a name="GtkAction.see-also"></a><h2>See Also</h2>
<p><a class="link" href="GtkActionGroup.html" title="GtkActionGroup"><span class="type">GtkActionGroup</span></a>, <a class="link" href="GtkUIManager.html" title="GtkUIManager"><span class="type">GtkUIManager</span></a>, <a class="link" href="GtkActivatable.html" title="GtkActivatable"><span class="type">GtkActivatable</span></a></p>
</div>
</div>
<div class="footer">
<hr>Generated by GTK-Doc V1.33.1</div>
</body>
</html>